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1 .  INTRODUCTION 

The  Computer-Aided  Mathematical  Analysis  system  (CAMA) 
permits  construction  of  symbols  and  expressions,  manipula¬ 
tion  of  expressions,  and  solution  of  equations.  CAMA  op¬ 
erates  under  MTS  in  the  IBM  360/67  and  RAMP  in  the  PDP-8/338 
terminal.  CAMA  operations  are  divided  into  tasks  which  may 
be  inserted  into  the  queue  via  commands. 


2.  USER'S  GUIDE  FOR  COMMAND  DPR0B 
The  command  DPR0B  is  used  to  define  a  problem.  Execu¬ 
tion  of  this  command  causes  a  flag  to  be  set  so  that  a 
second  specification  of  the  command  is  ignored  until  the 
first  request  is  completed.  The  command  has  four  branches: 
(1)  construct  symbols,  (2)  select  symbols  for  a  problem, 

(3)  define;  expressions  for  a  problem,  (4)  escape  to 

to  the  CAMA  system. 

(1)  Construct  symbols. 

The  user  specifies  the  menu  into  which  the  gener¬ 
ated  symbol  will  be  placed.  He  constructs  and 
names  the  symbol.  Options  exist  during  construc¬ 
tion  for  erasing  the  existing  symbol  and  starting 
again  or  rejecting  the  entire  stage.  If  the  user 
duplicates  a  symbol  name,  he  may  rename  the  sym¬ 
bol  or  destroy  the  old  definition  as  he  wishes. 

(2)  Select  Symbols  for  Problem. 

The  user  specified  a  problem.  If  the  problem 
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exists  and  contains  symbols,  the  symbols  are 
displayed.  The  user  selects  entire  menus  or 
particular  symbols  from  menus  to  be  included 
in  his  problem.  He  may  remove  one  or  all  sym¬ 
bols  from  his  problem.  A  maximum  of  63  sym¬ 
bols  may  be  included  in  one  problem. 

(3)  Define  Expressions  for  a  Problem. 

The  user  specifies  a  problem  and  the  problem 
symbols  are  displayed.  He  may  display,  modify, 
and  save  or  destroy  an  existing  expression  of 
the  problem,  or  create  and  save  a  new  expression. 

2 . 1  DATA  STRUCTURE 

2.1.1.  Master  Directory  Entries 

The  command  DPR0B  uses  entries  MS YMT&L ,  MPROB ,  NAMEFLAG, 
and  PR0BLEM  (see  Fig.  1)  in  the  master  directory  and  the 
corresponding  packs.  MSYMTBL  is  a  name-list  containing 
the  names  of  all  menus,  both  system  menus  and  user-named 
menus  containing  user-created  symbols,  and  pointers  to  the 
menu  packs.  The  menu  packs  are  lists  of  symbols  in  the 
manu  and  pointers  to  the  data  pack  which  contains  the  dis¬ 
play  file  for  the  symbol. 

MPR0B  is  a  list  of  problems  and  corresponding  pack 


pointers.  A  problem  pack  is  an  association  table  identi¬ 
fying  the  symbols  in  a  problem.  The  association  object  is 
the  symbol  name,  and  the  value  is  the  name  of  the  menu 
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Figure  1.  Entries  in  Master  Directory 
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containing  the  symbol. 

The  NAMEFLAG  entry  in  the  master  directory  points 
to  an  association  table  which  identifies  the  current  prob¬ 
lem  and  menu,  and  indicates  the  availability  of  this  com¬ 
mand. 

PROBLEM  is  a  name-list  of  problems  and  the  corre¬ 
sponding  pointers.  The  problem  packs  are  name-lists  of 
expressions  in  the  specific  problem  and  pointers  to  the 
data  packs  defining  the  expressions. 

2.1.2.  Data  Packs 

The  first  ten  words  of  the  symbol  display  file  data 
pack  are  the  display  file  header  (PSECT2  of  the  DF  rou¬ 
tines1)  .  Byte  1  of  word  1  and  words  6,  the  buffer  loca¬ 
tion  pointer,  7,  the  PDP-8  word  count,  and  9,  the  first 
location  of  the  actual  buffer,  must  be  set  to  appropriate 
values  before  the  display  file  is  transmitted.  Switch  1 
which  is  byte  1  of  word  1  should  be  set  to  40^g  so  the  DF 
routines  will  not  modify  the  last  location  of  the  display 
file.  The  remainder  of  the  data  pack  contains  the  display 
file  with  one  338  word  stored  in  two  bytes  using  six  bits 
in  each  byte,  as  described  end  illustrated  in  Appendix  C 
of  The  DF  Routines  User's  Guide1. 

Data  packs  are  also  used  to  define  the  expression 
with  one  20-byte  entry  for  each  symbol  of  the  expression 
(see  Fig.  2) . 
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Figure  2. 

The  entry  contains  the  X  and  Y  coordinates  of  the  symbol 
in  raster  points,  the  symbol  name,  the  scale  for  the  sym¬ 
bol  in  range  1-3,  and  the  entity  number.  (The  entity 
number  is  not  used  in  command  DPR0B  and  will  be  discussed 
in  greater  detail  when  relevant.) 

2.2  GENERAL  EXECUTION  STRUCTURE 

The  general  sequence  of  execution  of  command  DP ROB 
is  illustrated  in  Fig.  3.  Successive  tasks  are  executed 
in  the  central  computer  in  response  to  light  button  re¬ 
quests  until  the  user  chooses  to  exit  from  the  command. 

Command  DPR0B 


Task  TKDPB 

~ii 

Task  DMAIN 


1 

T~~ 

* 

Task  DPDEF 

Task  DCSYM 

Task  SYSEL 

CAMA 

I 

Task  SSGTSK 

i - i _ j 


Figure  3 
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Task  TKDPB 

Task  TKDPB  examines  the  NAMEFLAG  association  table. 
If  the  association 

DPR0B  FLAG  0N 
is  present,  a  comment 

TASK  IN  CURRENT  USE  . . .  NEW  REQUEST  IGNORED, 
is  printed  and  a  return  is  made  to  the  CAMA  system.  If 
the  flag  association  is  not  present,  the  task  DMAIN  is 
executed. 

Task  DMAIN 

The  DMAIN  task  is  the  main  branching  stage.  The 
light  buttons 

ESCAPE 

PR0BLEM  DEFINITI0N 

CONSTRUCT  SYMB0LS 

SELECT  SYMB0LS  F0R  PR0BLEM 

are  displayed.  The  user  indicates  the  desired  option 
with  the  Grafacon.  If  the  user  chooses  to  exit  command 
DPR0B  via  the  ESCAPE  button,  all  DPR0B  entries  in  the 
NAMEFLAG  table  are  erased  and  a  return  is  made  to  the 
CAMA  system. 

Task  DPDEF 

Task  DPDEF  is  the  response  to  the  PROBLEM  DEFINITION 
light  button  of  task  DMAIN.  The  execution  of  DPDEF  is 
outlined  in  Fig.  4.  The  display  screen  is  illustrated  in 
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Fig.  5. 

Task  DCSYM 

Task  DCSYM  is  the  response  to  the  CONSTRUCT  SYMB0LS 
light  button.  The  360  program  which  generates  and  trans¬ 
mits  the  display  files  is  outlined  in  Fig.  6.  The  PDP-8 

programs,  specifically  the  actual  symbol  construction  pro- 

2 

gram,  will  be  discussed  in  a  subsequent  memo  .  The  display 
screen  is  illustrated  in  Fig.  7. 

Task  SSGTSK 

The  SSGTSK  task  moves  the  display  file  for  the  con¬ 
structed  symbol  from  a  line  directory  to  a  data  pack  as 
described  in  Section  2.1.2.  Execution  of  the  task  will 
be  discussed  in  another  memc?. 

Task  SYSEL 

Task  SYSEL  is  executed  as  the  response  to  the 
SELECT  SYMBOLS  FOR  PROBLEM  light  button.  The  subrou¬ 
tine  is  outlined  in  Fig.  8.  A  maximum  of  63  symbols  may 
be  selected  for  a  problem.  The  display  screen  is  illus¬ 
trated  in  Fig.  9. 


Fine  and  confirm  current  problem  name 
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Figure  4.  Subroutine  DPDEF ,  continued 
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Figure  4.  Subroutine  DPDEF,  continued 
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AREA 


PROBLEM  SYMBOL  DISPLAY  AREA 


LIGHT  BUTTON  AREA 


Figure  5.  Display  Screen  for  DFDEF 
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Ready  display/  blank  screen. 

1 

Find  and  confirm  current  menu  name. 

Enter  menu  name  in  MSYMTBL  list  and  create  menu  list  or  ob¬ 
tain  pointer  to  existing  menu  list. 

I 

Call  CAMSET  which  executes  PDP-8  code  to  save  main  display 
file  locations.  | 


Transmit  a  square  as  a  subroutine  display  file. 

Transmit  a  small  square  as  a  main  display  file.  This  will 
later  be  used  to  indicate  the  Grafacon  location  by  altering 
the  end  point  of  the  first  invisible  vector. 

Transmit  the  light  buttons/  each  as  a  main  display  file  con¬ 
taining  a  push-jump  to  the  subroutine  box,  the  text  of  the 
label,  and  a  stop  blink  code. 

Transmit  the  grid  of  endpoints  by  first  generating  and  trans¬ 
mitting  as  a  subroutine  file  a  line  of  eight  points.  The 
grid  is  displayed  as  two  main  display  files  each  containing 
four  push- jumps  to  this  subroutine  file. 

Transmit  a  box  to  contain  the  symbol.  The  user  generates 
the  symbol  on  a  large  scale  for  convenience.  The  symbol  in 
the  box  shows  the  actual  transmitted  size. 

I 

Call  CAMSET  to  stop  saving  main  display  file  locations. 

I 

Find  the  data  pack  containing  the  PDP-8  symbol  generation 
program. 

Call  PR0G  to  transmit  the  program  to  the  PDP-8.  PROG  exe¬ 
cutes  a  PDP-8  task  which  reads  the  transmitted  program, 
stores  it,  and  transfers  to  the  starting  location  of  the 
transmitted  code. 


Figure  6.  Subroutine  DCSYM. 
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Figure  7.  Display  Screen  for  DCSYM 


Ready  display,  blank  screen 
Set  LMP=0 . 
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Figure  8.  Subroutine  DSYSEL 
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LIGHT  BUTTON  AREA 


Figure  9.  Display  Screen  for  DSYSEL 
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2.3  SUBROUTINES  USED  IN  DPR0B  COMMAND. 

Subroutine  SE8  is  used  to  display  a  string  of  sym¬ 
bols  contained  in  a  data  pack  with  entries  as  shown  in 
Fig.  2.  The  string  could  be  an  expression,  entries  in 
a  matrix,  or  a  list.  The  subroutine  has  one  entry  point, 
SE8MY,  which  can  be  used  to  set  the  minimum  Y  value  to 
be  displayed.  This  prevents  the  string  from  displaying 
over  light  buttons  or  other  information  located  at  the 
bottom  of  the  screen.  The  execution  of  SE8  and  SE8MY 
is  outlined  in  Fig.  10. 

Subroutine  EX0RD  orders  one  expression  data  pack  into 
another  with  increasing  X,  then  increasing  Y  as  outlined 
in  Fig.  11. 

Subroutine  EXL0C  examines  an  expression  data  pack  and 
returns  the  displacement  to  the  entry  located  at  a  speci¬ 
fied  coordinate  position  (see  Fig.  12) .  The  entries  in 
the  data  pack  are  not  in  any  particular  order. 

'  Subroutine  INIT8  locates  and  transmits  all  the  sym¬ 

bols  of  a  problem  as  invisible  display  files.  The  DF 
numbers  are  acquired  dynamically  and  then  saved  for  refer¬ 
ence  in  the  negative  region  of  the  symbol  display  file  data 
pack.  The  entry  point  I8REG  also  saves  the  DF  numbers  in 
an  array  with  the  array  subscript  equivalent  to  the  posi¬ 
tion  in  the  problem  association  table.  The  execution  of 
INIT8  and  18REG  is  outlined  in  Fig.  13. 


J 
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Arguments: 

LPK  «  pointer  to  expression  data  pack, 
NUM  ■  display  file  number  for  expression. 


Retrieve  problem  name  from  negative  region  of  pack. 
Find  pointer  to  problem  association  table. 


Blank  display  file  NUM. 
Initialize  display  file. 


©-** 


Read  entry  from  LPK. 

L 


entry 


end  of  pack 


Transmit  display 
•files  with  DF 
number  NUM. 


return 


Are  values  of  X  and  Y  coordinates  within  display  area? 
re  s  1  ■—  '■  no 


Find  name  of  menu  containing  this  symbol  from  problem  asso¬ 
ciation  table. 

Find  pointer  to  menu  name  list. 

Find  pointer  to  symbol  display  file  data  pack  in  menu  name 
list. 

Find  invisible  subroutine  display  file  number  in  negative 
region  of  symbol  display  file  data  pack. 


I 


Enter  Y,  X  with  escape,  PAR  to  reset  the  scale,  a  push- jump  to 
the  symbol  subroutine  file,  and  standard  PAR  and  MODE  into 
the  expression  display  file. 

Reset  the  internal  DF  light-beam  coordinates. 


6 


Entry  SE8MY  in  subroutine  SE8. 
Argument: 

MY  ■  minimum  Y  for  display  area. 


Set  minimum  Y  to  be  used  for  display  area  lower  bound  in  SE8. 


Figure  10.  Subroutine  SE8 
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Arguments : 

LEXP  *  pack  to  be  ordered, 

LEPK  =  pack  to  contain  the  result  of  ordering. 


Empty  pack  LEPK. 

Set  displacement  for  pack  LEPK  to  0. 


CM 


end  of  pack 


Read  entry  from  LEXP 

not  end  1 — 

of  pack 

V 


Is  scale  -  0? 


yes 


Save  displacement  to  this 
entry  and  X  and  Y  values. 


Read  next  entry  in  pack. 
|not  end 


|of  pack 
Is  scale  ii  0? 


end  of  pack 


no 


|yes 


*© 


If  (new  X  <  saved  X)  or  (new  X  - 
saved  X  and  new  Y  <  saved  Y) ,  replace 
saved  value  with  corresponding  values 
for  this  entry. 


V 

Move  entry  with  lowest  X,Y 
pack  LEPK. 

Increment  displacement  for 
Set  scale  in  entry  in  LEXP 

A 


Copy 

to 

LEPK. 
to  -1. 


9 

pack  LEPK  to  pack  LEXP. 

1 

return 


Figure  li  .  Subroutine  EX0RD 
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Arguments : 

IXL, IYL  ■  position  usually  of  Graf aeon  hit, 
LEXP  *  expression  data  pack, 

KDIS  *  displacement. 


on  a  symbol, 
return  1 


Figure  12.  Subroutine  EXL0C 
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Arguments : 

S?R0  -  problem  name. 

NSUB  =  array  to  save  subroutine  display  file 
numbers. 


INIT8 


1 8  REG 


I 


* 


Set  switch*! 


r 


Set  8witch*2 
_ I 


Find  pointer  to  problem  association  table. 
Find  all  symbol  and  corresponding  menu 
names  in  problem* 


4 


Find  pointer  to  pack  containing  display 
file  for  symbol.  Transmit  symbol  as 
invisible  subroutine  file. 

If  switch=2,  save  DF  number  in  array  NSUB. 
Move  DF  number  into  negative  region  of 
symbol  display  pack. 


* 


Are  all  symbols  processed? 


Figure  13.  Subroutine  INZT8 
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Subroutine  FONE  is  used  to  define  and  mark  entities. 
The  user  indicates  the  position  of  the  entity  marks-- 
above  or  below  the  expression — and  points  to  the  first 
and  last  symbols  to  be  included  in  the  entity.  The  ex** 
pression  is  blanked  and  redisplayed  with  the  indicated 
group  of  symbols  marked. 

The  subroutine  exists  as  a  routine  independent  of 
CAMA  in  file  FONE  with  changes  necessary  to  task  under 
CAMA  indicated  on  the  listing.  A  test  program  is  located 
in  FONE  (-100,-97).  The  object  of  the  subroutine  only  is 
in  FONEO.  The  RUN  command  is 

RUN  ( tes t ) +FONEO+MATH+SAVE : XDF+SAVE : CAMA/L  2=SS73 : TSAV2 . 
The  execution  sequence  of  the  subroutine  is  outlined  in 
Fig.  14.  The  display  screen  is  illustrated  in  Fig.  15. 


Ready  display,  blank  screen. 
Display  light  buttons. 


Figure  14.  Subroutine 
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Figure  14.  Subroutine  EX0NE,  concluded 
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Figure  15.  Display  Screen  for  FONE 
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